<html>
<head>
<title>Jenkins command-line preferences</title>
</head>
<body>
<h1>Jenkins command-line preferences</h1>

<p><a href="https://wiki.jenkins-ci.org/display/JENKINS/Starting+and+Accessing+Jenkins">The Jenkins Wiki page</a> tells you how to change settings like which port number Jenkins will listen to. These settings need to be specified on the command line when Jenkins is started.

<h4>Launch daemon</h4>

<p>For the Mac, Jenkins is deployed as a launch daemon. (If you want to know more about launchd and daemons, see <a href="http://developer.apple.com/library/mac/#technotes/tn2083/_index.html">here</a> and <a href="http://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPSystemStartup/Articles/LaunchOnDemandDaemons.html">here</a>)

<p>The launch daemon picks up the command line options from a standard preferences file, <tt>/Library/Preferences/org.jenkins-ci.plist</tt>. If the file does not exist, built-in defaults are used. The preference files are manipulated using the standard utility <tt>defaults</tt>.

<h4>How To Use the defaults Command</h4>

<p>To view all settings in the file, run:
<tt>defaults read /Library/Preferences/org.jenkins-ci</tt>

<p>To get the value of a single setting, run:
<tt>defaults read /Library/Preferences/org.jenkins-ci SETTING</tt>

<p>To set the value of a setting, run:
<tt>defaults write /Library/Preferences/org.jenkins-ci SETTING VALUE</tt>

<p>For more information, see <tt>man defaults</tt>

<h4>Supported Settings</h4>

<p>The list of settings supported by the Jenkins launch daemon (see <a href="http://winstone.sourceforge.net/#commandLine">documentation</a>):

<ul>
<li>prefix
<li>httpPort
<li>httpListenAddress
<li>httpsPort
<li>httpsListenAddress
<li>ajp13Port
<li>ajp13ListenAddress
</ul>

<p>Additionally, you can set also these:

<ul>
  <li>war (Full path name to jenkins.war file. Defaults to <tt>/Applications/Jenkins/jenkins.war</tt>)
  <li>JENKINS_HOME (Full path to JENKINS_HOME directory where Jenkins keeps its files. Defaults to <tt>/Users/Shared/Jenkins</tt>)
  <li>minHeapSize (Passed to java command-line <tt>-Xms</tt> parameter. Defaults to 256m on 64bit architectures and 64m on 32bit)
  <li>heapSize (Passed to java command-line <tt>-Xmx</tt> parameter. Defaults to 512m on 64bit architectures and 128m on 32bit)
  <li>minPermGen (Passed to java command-line <tt>-XX:PermSize</tt> parameter. Defaults to 256m on 64bit architectures and 64m on 32bit)
  <li>permGen (Passed to java command-line <tt>-XX:MaxPermSize</tt> parameter. Defaults to 512m on 64bit architectures and 128m on 32bit)
</ul>

</body>
</html>
